From 75fd27e9205a9e1656562b0fa03de20a027cee1a Mon Sep 17 00:00:00 2001
From: Matthias Clasen <mclasen@redhat.com>
Date: Sat, 30 Oct 2010 21:25:21 -0400
Subject: [PATCH] Improve GtkAssistant docs

---
 gtk/gtkassistant.c | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/gtk/gtkassistant.c b/gtk/gtkassistant.c
index 3fc0616bb0..10241a399f 100644
--- a/gtk/gtkassistant.c
+++ b/gtk/gtkassistant.c
@@ -32,6 +32,13 @@
  * operation splitted in several steps, guiding the user through its pages
  * and controlling the page flow to collect the necessary data.
  *
+ * The design of GtkAssistant is that it controls what buttons to show and
+ * to make sensitive, based on what it knows about the page sequence and
+ * the <link linkend="GtkAssistantPageType">type</link> of each page, in
+ * addition to state information like the page
+ * <link linkend="gtk-assistant-set-page-complete">completion</link> and
+ * <link linkend="gtk-assistant-commit">committed</link> status.
+ *
  * <refsect2 id="GtkAssistant-BUILDER-UI">
  * <title>GtkAssistant as GtkBuildable</title>
  * <para>
-- 
2.30.2